Batch Availabilities

Get availabilities and nightly rates of multiple properties between given dates.

HTTP Request

POST https://dev.calry.app/api/v2/vrs/availability/batch

Headers

Header	Value
Authorization	Bearer YOUR_ACCESS_TOKEN
workspaceId	YOUR_WORKSPACE_ID
integrationAccountId	YOUR_INTEGRATION_ACCOUNT_ID

Request Body

Field	Type	Description
propertyIds	string[]	Required. Unique Identifiers of the properties.
roomTypeIds.propertyId	string	Required. Unique Identifier of the property.
roomTypeIds.roomTypeId	string[]	Required. Unique Identifiers of the room types of the associated property.
startDate	string	Required. The start date of the availability check in YYYY-MM-DD format.
endDate	string	Required. The end date of the availability check in YYYY-MM-DD format.
rates	bool	Optional. Determines whether nightly rates and stay information should be included in the response.

Example Request

curl --location 'https://dev.calry.app/api/v2/vrs/availability/batch' \
--header 'Authorization: Bearer eyJraWQiOiJzUWasaswMwMzE2MzExLTg3NDktNGNhMC05NDg0LTBlNWM1ZDVlMDExOSIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJpc3MiOiJodHRwczovL2Rldi5jYWxyeS5hcHAvYXBpL2F1dGgiLCJ1c2VySWQiOiJjNjhmODE5My1lNjEwLTQ2NjItOTc1OC1kNmYxMmFhODAwODYiLCJ3b3Jrc3BhY2VJZCI6IjE0ODc3OTZkLTNmY2QtNGE2Mi04ODRhLTNhYWJhNTA3ZTczMiIsIm5hbWUiOiJ0ZXN0IGtleSIsInNvdXJjZSI6Im1pY3Jvc2VydmljZSIsImlhdCI6MTczODE1MjkyMSwoxNzc0MTUyOTIxfQB1va47u7biYinOcdbZymTHb34dCj9KqH3GkljySDlIRB1v-Puqytc4lWpIdXFpbq-HYF6o7efv0Pjk8Co4cEw3yBX1ZnHeh5g474lnut4W04WcxwGIsHCLGEpA-rLjDbIEYNZg8-bL-sTD0JJo-uw1Law2krNdS55IhPvUIt-chtQQ7HMuvuBkgSsX6I15ODCU6DZEgmdzFTg8MdT5hfuBY5TMLdLHaF1YEMs_lFAyQoXPdNjfCU6Gi2Qp5NHltjAT6rwmfGoDTzl0ZCb32NaR92GuWekhtPu2JKQ4sX9ti8xuKokM1vVGQHlntPSp77AGpWST707SGGyzhnAbNLcA' \
--header 'workspaceId: 1487796d-3fcd-4a62-884a-3aaba507e732' \
--header 'integrationAccountId: 79aa8280-55ab-4048-9eaf-d13108d39ef7' \
--data '{
  "propertyIds": [
    "279411",
    "279414"
  ],
    "roomTypeIds": [
    {
      "propertyId": "279411",
      "roomTypeId": [
        "341959"
      ]
    },
    {
      "propertyId": "279414",
      "roomTypeId": [
        "341967"
      ]
    }
  ],
  "startDate": "2025-02-15",
  "endDate": "2025-02-20",
  "rates": true
}'

Example Response

{
    "success": true,
    "data": [
        {
            "propertyId": "279411",
            "roomTypeId": "341959",
            "dateWiseAvailability": [
                {
                    "date": "2025-02-15",
                    "status": "NOT_AVAILABLE",
                    "price": {
                        "amount": 139
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                },
                {
                    "date": "2025-02-16",
                    "status": "NOT_AVAILABLE",
                    "price": {
                        "amount": 109
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                },
                {
                    "date": "2025-02-17",
                    "status": "AVAILABLE",
                    "price": {
                        "amount": 109
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                },
                {
                    "date": "2025-02-18",
                    "status": "AVAILABLE",
                    "price": {
                        "amount": 89
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                },
                {
                    "date": "2025-02-19",
                    "status": "AVAILABLE",
                    "price": {
                        "amount": 99
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                },
                {
                    "date": "2025-02-20",
                    "status": "AVAILABLE",
                    "price": {
                        "amount": 119
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                }
            ]
        },
        {
            "propertyId": "279414",
            "roomTypeId": "341967",
            "dateWiseAvailability": [
                {
                    "date": "2025-02-15",
                    "status": "NOT_AVAILABLE",
                    "price": {
                        "amount": 179
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                },
                {
                    "date": "2025-02-16",
                    "status": "NOT_AVAILABLE",
                    "price": {
                        "amount": 159
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                },
                {
                    "date": "2025-02-17",
                    "status": "AVAILABLE",
                    "price": {
                        "amount": 89
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                },
                {
                    "date": "2025-02-18",
                    "status": "AVAILABLE",
                    "price": {
                        "amount": 89
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                },
                {
                    "date": "2025-02-19",
                    "status": "AVAILABLE",
                    "price": {
                        "amount": 99
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                },
                {
                    "date": "2025-02-20",
                    "status": "AVAILABLE",
                    "price": {
                        "amount": 119
                    },
                    "minimumNights": 1,
                    "maximumNights": 0
                }
            ]
        }
    ]
}